home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / rwdlst1c.zip / RWDLIST.DOC < prev    next >
Text File  |  1992-03-25  |  7KB  |  168 lines
  1.                                RWDir
  2.  
  3.                         Download Files Lister
  4.                         =====================
  5.  
  6.                         Vers 1.0C Beta 3/25/92
  7.  
  8.      RWDLIST.EXE is a utility to create DOWNLOAD LISTS from a PCBoard's
  9.      File Directories. It can Merge in your HEADERS (produced by RWDir),
  10.      and optionally strip out "Uploaded by" records from the directories
  11.  
  12.      Since this is Beta, the dox will be a little sparse...
  13.  
  14.      Copy and RUN RWDLIST.EXE from inside your \RWDIR\ directory!
  15.  
  16.      You must pass a command line parameter to it; the name of the
  17.      configuration file for RWDLIST.EXE to use!  Example:
  18.  
  19.              RWDLIST dlist01.cfg
  20.                      ^^^^^^^^^^^
  21.                      |
  22.                      --> name of your configuration file you want to use
  23.                          (any name can be used)
  24.  
  25.      CONFIGURATION FILE LAYOUT and OPTIONS:
  26.      -------------------------------------
  27.  
  28.      The Cfg file  may contain any of several optional parameters, in
  29.      any order:
  30.  
  31.      HEADERS=YES or NO       [OPTIONAL]
  32.  
  33.        Do you want to have the HEADERS Included in the listing?
  34.        Default is YES. (@X## PCB Color codes will be removed from all
  35.        headers prior to writing into the download listing.)
  36.  
  37.      UPBYREC=YES or NO       [OPTIONAL]
  38.  
  39.        Default is YES. Directory records with "Uploaded by" WILL be
  40.        included. (use NO to have them removed)
  41.  
  42.      TOPFILE=filename        [OPTIONAL]
  43.  
  44.        If you want RWDLIST.EXE to Merge a file on the TOP of the
  45.        Download list, place its filename here. Omit this if you do
  46.        Not have/need for it.
  47.  
  48.      BOTFILE=filename        [OPTIONAL]
  49.  
  50.        If you want RWDLIST.EXE to Merge a file at the END of the
  51.        Download list, place its filename here. Omit this if you do
  52.        Not have/need for it.
  53.  
  54.      OUTFILE=filename        [REQUIRED]
  55.  
  56.        This is the filename which you want to use for the actual
  57.        Download listing file. If it already exists, it will be
  58.        overwritten!
  59.  
  60.      RWDLIST: Second Beta Release    New Features:
  61.      =============================================  03/17/92 rd.
  62.  
  63.      Page Breaks!  You may specify the number of lines-per-page before
  64.      we insert a FORMS FEED character. Use the following cfg parameter:
  65.  
  66.      PAGEBRK=##  If you do NOT want ANY page-breaks, specify ZERO, else
  67.                   enter the # of lines per page. 60 or less recommended!
  68.  
  69.      When PAGEBRK is used (non-zero), RWDList will insert forms-feed
  70.      characters every ## lines (as specified in PAGEBRK=##) *AND* at
  71.      the begining of Every new Header.
  72.      Each new Page will contain a forms-feed, BBSNAME, and a Pg Number.
  73.      LaserJets print 60 lines-per page; DeskJets 57- be nice¡ Not all
  74.      printers print 66 lines on a page!!
  75.  
  76.      BBSNAME= ... up to 70 characters in length (Dont use "@" codes!)
  77.                (it would be smart to include your bbs phone # here!)
  78.  
  79.      Works in conjunction with PAGEBRK parameter. If Page Breaks are to
  80.      be produced, the top of every new page will include this info;
  81.      EXCEPT when a new page was forced because of a HEADER! The BBSNAME
  82.      is NOT included in the page-break on HEADERS-
  83.  
  84.  
  85.      RWDLIST: Third Beta Release    New Features:
  86.      =============================================  03/25/92 rd.
  87.  
  88.      Added Configuration parameter:  REMOVE|=YES/NO
  89.  
  90.      Default = YES
  91.  
  92.      This will remove those pesky little | characters from the Directory
  93.      secondary description lines.
  94.  
  95.      Added Configuration parameter: /M:filename
  96.  
  97.      Like TOPFILE and BOTFILE except that you may place this anywhere
  98.      After the other parameters and the filename will be merged into
  99.      the download list file. It can NOT appear Before the TOPFILE nor
  100.      after the BOTFILE parameters!! TOPFILE will ALWAYS BE FIRST, and
  101.      BOTFILE will ALWAYS BE LAST. /M: files can be used JUST BEFORE the
  102.      First Directory Filename record in the cfg, inbetween any directory
  103.      filenames, and CAN be the last line in the Cfg (it will display
  104.      after the last Directory and BEFORE the BOTFILE)
  105.  
  106.      Included a file called FORMFEED.RWD which contains nothing more
  107.      than a printer control code to advance to the Next-page. Usefull
  108.      if the file you are Merging (/M:) doesnt have one and its needed.
  109.  
  110.      MERGED FILES are NOT stripped of any PCB "@" codes !! If you need
  111.      to have these codes removed, create a stripped version of the file
  112.      using one of the many utilities available to create one. This
  113.      utility removes "@X##" color codes and @CLS@ ONLY from Dir HEADERS
  114.      that were produced by RWDir!
  115.  
  116.  
  117.     SAMPLE CFG File:  DLIST01.CFG
  118.     --------------------------------
  119.     HEADERS=YES
  120.     UPBYREC=NO
  121.     REMOVE|=yes
  122.     PAGEBRK=60
  123.     BBSNAME=  Richware Shareware BBS Files Listing  (708) 697-1606
  124.     TOPFILE=C:\PCB\GEN\WELCOME
  125.     BOTFILE=C:\PCB\SUBSCRIB.FRM
  126.     OUTFILE=GRAPHICS.LST
  127.     /M:formfeed.rwd
  128.     /M:grphinfo.txt          -> a merge (after TOPFILE)
  129.     /M:formfeed.rwd
  130.     C:\PCB\DIR\MAIN01        \
  131.     C:\PCB\DIR\MAIN03          \
  132.     C:\PCB\DIR\WIND01            \ _ Directories to be included in the
  133.     /M:formfeed.rwd
  134.     /M:picinfo.txt                /-
  135.     C:\PCB\DIR\PICS01            /   download listing follow parameters
  136.     C:\PCB\DIR\PICS02          /
  137.     C:\PCB\DIR\PICS03        /
  138.     ---------------------- end of Sample CFG
  139.  
  140.  
  141.                I told ya they would be sparse dox, eh?
  142.  
  143.     RWDlist 0.8b    3/17/92
  144.     =======================
  145.  
  146.     RWDlist is an add-on to the popular RWDir utility [RWDIR21.ZIP]. It
  147.     will work on PCBoard directory files; Inclusion of HEADERS works
  148.     only with RWDir produced Headers!
  149.  
  150.     RWDlist is SHARE & NET & DV compatible! It CAN be run while your
  151.     directories are being viewed by an online caller.
  152.  
  153.  
  154.     If you have suggestions/recommendations for RWDlist (or RWDir) call
  155.     the Richware Shareware BBS at (708) 697-1606 (V32bis) and leave us
  156.     your comments. (708) 695-1613 (HST/DUAL) if you are a registered
  157.     user of any "RW" software...
  158.  
  159.              Rich.
  160.  
  161.     We apologise for the documentation in this release... it WILL get
  162.     better after Beta. RWDLIST is not intended to be a Standalone
  163.     PCB utility- it is Part of the RWDir system and is subject to all
  164.     Shareware License agreements.
  165.  
  166.     ** We now have ONLINE VISA/MC Registration for RWDir and RWCnf on
  167.        the BBS!
  168.